Skip to content

gh-76607: Improve documentation of the tkinter cursor option#152481

Merged
serhiy-storchaka merged 1 commit into
python:mainfrom
serhiy-storchaka:gh-76607-cursor-doc
Jul 5, 2026
Merged

gh-76607: Improve documentation of the tkinter cursor option#152481
serhiy-storchaka merged 1 commit into
python:mainfrom
serhiy-storchaka:gh-76607-cursor-doc

Conversation

@serhiy-storchaka

@serhiy-storchaka serhiy-storchaka commented Jun 28, 2026 •
edited by bedevere-app Bot
Loading

Copy link
Copy Markdown
Member

The documentation of the cursor option type only listed the X cursorfont.h names and referred to "page 179 of Ousterhout's book", with no pointer to the actual list of cursor names.

Link instead to the cursors(3tk) manual page for the full, up-to-date list, and note that the available names are platform-dependent (the portable Tk set vs. X11 vs. native Windows/macOS cursors).

Also add a cross-reference from the ttk standard cursor option to the Tk option data types section.

@serhiy-storchaka @claude
pythongh-76607: Improve documentation of the tkinter cursor option
bf13de3 
Link to the cursors(3tk) manual page for the available cursor names and
note that they are platform-dependent.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Jun 28, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jun 28, 2026
@bedevere-app bedevere-app Bot mentioned this pull request Jun 28, 2026
Closed
@serhiy-storchaka serhiy-storchaka added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jun 28, 2026
@read-the-docs-community

read-the-docs-community Bot commented Jun 28, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33342655 | 📁 Comparing bf13de3 against main (a385d20)

  🔍 Preview build  

2 files changed
± library/tkinter.html
± library/tkinter.ttk.html

@serhiy-storchaka serhiy-storchaka merged commit ea57037 into python:main Jul 5, 2026
42 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Jul 5, 2026
@miss-islington-app

miss-islington-app Bot commented Jul 5, 2026

Copy link
Copy Markdown

Thanks @serhiy-storchaka for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

@serhiy-storchaka serhiy-storchaka deleted the gh-76607-cursor-doc branch July 5, 2026 11:13
@bedevere-app

bedevere-app Bot commented Jul 5, 2026

Copy link
Copy Markdown

GH-153110 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 pre-release feature fixes, bugs and security fixes label Jul 5, 2026
@bedevere-app

bedevere-app Bot commented Jul 5, 2026

Copy link
Copy Markdown

GH-153111 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Jul 5, 2026
@bedevere-app

bedevere-app Bot commented Jul 5, 2026

Copy link
Copy Markdown

GH-153112 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label Jul 5, 2026
serhiy-storchaka added a commit that referenced this pull request Jul 5, 2026
@miss-islington @serhiy-storchaka @claude
[3.13] gh-76607: Improve documentation of the tkinter cursor option (G…
15f91f5 
…H-152481) (GH-153112)

Link to the cursors(3tk) manual page for the available cursor names and
note that they are platform-dependent.
(cherry picked from commit ea57037)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
serhiy-storchaka added a commit that referenced this pull request Jul 5, 2026
@miss-islington @serhiy-storchaka @claude
[3.15] gh-76607: Improve documentation of the tkinter cursor option (G…
d1fde18 
…H-152481) (GH-153110)

Link to the cursors(3tk) manual page for the available cursor names and
note that they are platform-dependent.
(cherry picked from commit ea57037)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
serhiy-storchaka added a commit that referenced this pull request Jul 5, 2026
@miss-islington @serhiy-storchaka @claude
[3.14] gh-76607: Improve documentation of the tkinter cursor option (G…
34d8ed4 
…H-152481) (GH-153111)

Link to the cursors(3tk) manual page for the available cursor names and
note that they are platform-dependent.
(cherry picked from commit ea57037)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@terryjreedy terryjreedy Awaiting requested review from terryjreedy

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@serhiy-storchaka